home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-11 / nan_s789.zip / S50007.TXT < prev    next >
Text File  |  1992-02-15  |  4KB  |  123 lines
  1. CLIPPER 5.0 SUPPORT BULLETIN #7
  2.  
  3. BULLETIN REVISED: 22nd Jan, 1992
  4.  
  5. PRODUCT: Clipper 5.0
  6.  
  7. AFFECTED VERSIONS: 5.01
  8.  
  9. SUBJECT: RTLink Questions and Answers
  10.  
  11.  
  12. Q1: RTLink hangs occasionally with 386 Max (and other memory
  13. managers).  Can I disable RTLink's use of expanded memory?
  14.  
  15. A1: To turn off EMS useage, use SET RTLEMSOFF=1.  To turn off XMS
  16. useage, use SET RTLXMSOFF=1.
  17.  
  18. An alternative to slow swap files being created when you turn off
  19. EMS or XMS useage is to redirect the swap file to a RAMdisk.  To
  20. do this, specify WORKFILE E: in the link file, or set the
  21. environmental variable TMP to E:.
  22.  
  23.  
  24. Q2: Does incremental linking work?
  25.  
  26. A2: Yes, but it only works on Clipper code.  Therefore, the
  27. effect is not very noticable unless you use a prelinked library so
  28. that you are not relinking the code in CLIPPER.LIB.
  29.  
  30.  
  31. Q3: What is the difference between the RTLink LIB and SEARCH
  32. statements?
  33.  
  34. A3: Nothing.  SEARCH is included for compatibility only
  35.  
  36.  
  37. Q4: What is the easiest way to create a prelinked library?  How
  38. do I determine what should be REFERed and what should be EXCLUDEd?
  39.  
  40. A4: The easiest way to create a (.PLL) file is to use the
  41. NOTABLEOFCONTENTS command to list all the symbols that are being
  42. linked in.  You must also specify the VERBOSE command.  Then use
  43. REFER to specify these symbols in your linker script file.  REFER
  44. adds a symbol to the search request list, and EXCLUDE removes one.
  45.  
  46.  
  47. Q5: What is the current default stack size?
  48.  
  49. A5: 1000 hex (4096 dec).  If problems are encountered, try
  50. increasing the stack size to 5000 hex (20480 decimal).  This can
  51. be done using the STACK command, as follows:
  52.      STACK 5000     // 5000 hex
  53.      STACK 20480.   // Hex syntax, but period specifies decimal
  54.      /STACK:20480   // 20480 decimal
  55.      /STACK:5000.   // Hex syntax, but period specifies hex
  56.  
  57.  
  58. Q6: What does the error "Cannot combine common segment <segment
  59. name>" mean?
  60.  
  61. A6: Common segments cannot have a symbol in an .EXE and another
  62. in a prelinked library.  To correct the problem either EXCLUDE the
  63. symbol that is in the (.PLL) or INCLUDE the symbol that is in the
  64. .EXE.  Either way, both symbols must be moved so that they are in
  65. the same place.
  66.  
  67.  
  68. Q7: Is there any overhead associated with static overlays?
  69.  
  70. A7: Yes.  When a static overlay is created, the Static Overlay
  71. Manager is included in the .EXE file.  As this takes up about 10K,
  72. the overlay being created must save this much memory in order to
  73. be useful.
  74.  
  75.  
  76. ADDITIONAL NOTES
  77.  
  78. 1. Automatic search requests (the ones the compiler puts in to
  79. automatically search all the Clipper libraries) are satisfied
  80. AFTER the search of any libraries listed in the LIB statement.
  81. For example:
  82.  
  83.   RTLINK FI MyObj LIB FuncLib
  84.  
  85. FuncLib will be searched BEFORE Clipper, Extend, etc.  If you want
  86. CLIPPER.LIB to be searched before FuncLib, use the following:
  87.  
  88.   RTLINK FI MyObj LIB Clipper, FuncLib
  89.  
  90.  
  91. 2. The NOTABLEOFCONTENTS command can be used to prevent
  92. unresolved symbols in cases where the table of contents is not
  93. complete for some reason.  NoTableOfContents causes the linker to
  94. manually search each object and library file instead of using the
  95. table of contents to determine what symbols each file contains.
  96. Libraries created with Borland's TLIB utility have a table of
  97. contents that RTLink does not recognize, and should be linked
  98. using the NOTABLEOFCONTENTS command.
  99.  
  100.  
  101. 3. A prelinked library will satisfy a search request BEFORE any
  102. object or library files are searched.  Therefore, a symbol in a
  103. (.PLL) will always take precedence over a symbol in the (.OBJ) or
  104. (.LIB).
  105.  
  106.  
  107. 4. The MODULE command, which forces a file to be overlayed,
  108. overrides the LIB command, which causes symbols from the file
  109. being linked to be put into the root
  110.  
  111.  
  112. 5. To allow static overlays to be called from a symbol in the
  113. same overlay area, the command RELOAD FAR <stack size> must be
  114. used to allow the RETURN to take place properly.  The default
  115. figure for the reload stack is 100ûthis allows you to make 100
  116. calls into an overlay section before any RETURNs are recorded.
  117. Increasing this figure to 200 provides enough entries in the
  118. overlay entry table to handle the code and function calls in a
  119. standard C runtime library.
  120.  
  121.  
  122. END: CLIPPER 5.0 SUPPORT BULLETIN #7
  123.